home *** CD-ROM | disk | FTP | other *** search
/ BMUG PD-ROM 1995 Fall / PD-ROM F95.toast / Utilities / Extensions / C Extensions / ClicKey 1.1 ƒ / Read Me < prev   
Encoding:
Text File  |  1991-04-13  |  2.9 KB  |  40 lines  |  [TEXT/ttxt]

  1. ClicKey 1.1 Readme
  2. -----------------
  3.  
  4. ClicKey is an INIT that defines a rectangular piece of your screen as a "hot" region.  Clicking in the hot rectangle will cause a designated FKEY to be executed.  You can specify any number of different hot rectangles, each with its own FKEY.  The FKEY number need not be in the standard range 0 through 9.
  5.  
  6. ClicKey has no user interface.  To configure it, you must use ResEdit.
  7.  
  8. As distributed, ClicKey executes FKEY 3 (the standard screen dump FKEY) when you click in the lower right corner of the screen.
  9.  
  10.  
  11. Configuring ClicKey
  12. ------------------
  13.  
  14. Open ClicKey with ResEdit.  The configuration information is stored in resources of type ‘HotK’.   (It’s not a standard resource type, but ClicKey contains a template for it.)  You can edit the existing resource, or create your own.  There can be any number of HotK resources, and there is no restriction on resource IDs or names.  If you create a new HotK resource, be sure to set its System bit using “Get Resouce Info”.
  15.  
  16. The first thing to set in the HotK resource is the ID number of the FKEY that you want ClicKey to activate.  Next is a flag labelled “Change mousedown to null event?”.    If this is True, then after ClicKey has seen the mouse-click, no other application or INIT will see it.  (It is still possible for another INIT to see or even intercept a mouse click before ClicKey.)  In most cases it won’t matter much.
  17.  
  18. To specify the hot rectangle, you choose one of the 4 corners of the screen as the reference point, and then give the rectangle’s coordinates relative to that reference point.  For instance, to specify a 5 pixel by 5 pixel rectangle in the lower right corner of the screen, set the reference corner to 4 and set the rectangle to -5, -5, 0, 0.  If you click the Set button, you can drag-select a rectangle on the screen, and its coordinates, relative to the top left corner, will be filled in as the hot rectangle.
  19.  
  20.  
  21. About...
  22. ------
  23.  
  24. Thanks to Alex Chaffee and Jason Klivington for posting the source to a jGNEFilter INIT, Shift-O-Matic, on CompuServe.
  25.  
  26. James W. Walker
  27. Department of Mathematics
  28. University of South Carolina
  29. Columbia, SC 29208
  30.  
  31. CompuServe: 76367,2271
  32. America Online: JWWalker
  33. Internet: 76367.2271@compuserve.com
  34.  
  35.  
  36. Distribution Policy
  37. -----------------
  38.  
  39. ClicKey  is provided free of charge to all Macintosh users.  It may be distributed freely, provided that both the software and this documentation are always distributed together, in whole and unchanged.  ClicKey  may not be sold or offered for sale, or included with another software product offered for sale, except with the express written permission of the author.  Companies that distribute public domain/freeware/shareware software for profit are expressly prohibited from distributing ClicKey .  This restriction does not apply to bulletin boards, commercial on-line services such as America Online, CompuServe and GEnie, and non-profit Macintosh user groups which hold regularly scheduled public meetings.
  40.